home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / putbq.z / putbq
Encoding:
Text File  |  1998-10-30  |  4.0 KB  |  132 lines
  1.  
  2.  
  3.  
  4. ppppuuuuttttbbbbqqqq((((DDDD3333))))                                                            ppppuuuuttttbbbbqqqq((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_uuuu_tttt_bbbb_qqqq - place a message at the head of a queue
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _pppp_uuuu_tttt_bbbb_qqqq_((((_qqqq_uuuu_eeee_uuuu_eeee______tttt _****_q_,,,, _mmmm_bbbb_llll_kkkk______tttt _****_b_p_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _q         Pointer to the queue.
  18.  
  19.      _b_p        Pointer to the message.
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _pppp_uuuu_tttt_bbbb_qqqq puts a message back at the head of a queue.  If messages of a
  23.      higher priority are on the queue, then _b_p is placed at the head of its
  24.      corresponding priority band.  See _ssss_rrrr_vvvv(D2) for more information about
  25.      message priorities.
  26.  
  27.      All flow control parameters are updated.  The queue's service routine is
  28.      scheduled if it has not been disabled by a previous call to _nnnn_oooo_eeee_nnnn_aaaa_bbbb_llll_eeee(D3).
  29.  
  30.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  31.      _pppp_uuuu_tttt_bbbb_qqqq returns 1 on success and 0 on failure.
  32.  
  33. UUUUSSSSAAAAGGGGEEEE
  34.      _pppp_uuuu_tttt_bbbb_qqqq is usually called when _bbbb_cccc_aaaa_nnnn_pppp_uuuu_tttt(D3) or _cccc_aaaa_nnnn_pppp_uuuu_tttt(D3) determines that
  35.      the message cannot be passed on to the next stream component.
  36.  
  37.      _pppp_uuuu_tttt_bbbb_qqqq can fail if there is not enough memory to allocate the accounting
  38.      data structures used with messages whose priority bands are greater than
  39.      zero.
  40.  
  41.      High priority messages should never be put back on a queue from within a
  42.      service routine.
  43.  
  44.    LLLLeeeevvvveeeellll
  45.      Base or Interrupt.
  46.  
  47.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  48.      Does not sleep.
  49.  
  50.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  51.      across calls to this function.
  52.  
  53.    EEEExxxxaaaammmmpppplllleeeessss
  54.      See _bbbb_uuuu_ffff_cccc_aaaa_llll_llll(D3) for an example of _pppp_uuuu_tttt_bbbb_qqqq.
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. ppppuuuuttttbbbbqqqq((((DDDD3333))))                                                            ppppuuuuttttbbbbqqqq((((DDDD3333))))
  70.  
  71.  
  72.  
  73. REFERENCES
  74.      _bbbb_cccc_aaaa_nnnn_pppp_uuuu_tttt(D3), _cccc_aaaa_nnnn_pppp_uuuu_tttt(D3), _gggg_eeee_tttt_qqqq(D3), _iiii_nnnn_ssss_qqqq(D3), _mmmm_ssss_gggg_bbbb(D4), _pppp_uuuu_tttt_qqqq(D3),
  75.      _qqqq_uuuu_eeee_uuuu_eeee(D4), _rrrr_mmmm_vvvv_qqqq(D3), _ssss_rrrr_vvvv(D2)
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.